The World of Computer Software

home *** CD-ROM | disk | FTP | other *** search

/ The World of Computer Software / The World of Computer Software.iso / diskl264.zip / DISKLIST.DOC < prev next >

Wrap

Text File | 1992-09-16 | 67KB | 1,499 lines

D I S K L I S T Prints a Directory Listing on any Printer DISKLIST is a commercial program and is copyrighted. It is distributed using the Shareware marketing concept. The Shareware concept allows you to try the fully functional program on your own computer before you buy it. If you continue to use DISKLIST or keep it for when you might use it, then you MUST send the $25 registration fee to the author. Press F to print the registration form from the program. When you register DISKLIST you will receive: Telephone and mail support. A copy of the latest version of DISKLIST Removal of the Registration Screen & reminders. Skip the Help screen at the start of the program. Skip the Registration Form reminder at the end of the program. A loan amortization program with both the BASIC source code and the compiled program. No registration is required for the amortization program. A copy of SHERLOCK for you to try before registering. _______ ____|__ | (R) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER Table of Contents ----------------- OVERVIEW...............................1 FASTSTART..............................2 OPERATION..............................3 PARAMETERS and COMMANDS................4 LIST FORMATS...........................7 NONLASER PRINTER CONTROL CODES.........9 LASER COMMANDS........................11 DESKJET...............................13 AVERY LASER LABELS....................14 PRINT ON DISK SLEEVES.................16 SWITCH PRINTER PORT...................16 PAGE TAB VALUE........................17 LASER DOWNLOAD........................17 TEXT INPUT............................17 STATUS MESSAGES...................... 18 MONOCHROME MONITOR....................18 SUMMARY OF NON-DISPLAYED COMMANDS.....19 FILENAMES............................ 19 DISKFLAP..............................20 SHAREWARE............................ 20 MULTICOPY FEES........................22 FOREIGN REGISTRATIONS.................22 EPILOGUE..............................22 COMMERCIAL LABELS.....................23 OMBUDSMAN............................ 23 IBM GRAPHICS EXAMPLE..................24 Copyright 1991, 1992 John P. Bauernschub, Jr. Gulf Sierra 14809 Clavel Street Rockville, MD 20853 301-460-0354 CompuServe ID 73270,77 OVERVIEW DISKLIST is designed to print the directory of any disk, including subdirectories, on a stick on label, a sheet of paper that can be cut to the size of the diskette, on a disk sleeve, on an 8.5 x 11 sheet, the screen, or a disk file. The list can be in a format that is the size of the floppy so that it can be attached to the floppy, or, if on paper, trimmed to fit into the floppy sleeve. DISKLIST lists the contents of all of the subdirectories on the disk. DISKLIST provides an easy method to configure the output. Here is an example of one form of the output of DISKLIST. -------------------------------------------------- | GREAT SHAREWARE | | Volume ID is DISKLIST | | 1,457,664 Total Space 893,440 Bytes Free | |------------------------------------------------| | A:\ 153,664 BYTES | | DISKLIST.DOC 34,377 08/15/90 19:32:16 | | DISKLIST.EXE 119,144 08/14/90 22:02:18 | | DISKLIST.PRM 124 03/25/90 11:11:48 | | DISKLIST.TTL 19 03/25/90 11:05:06 | | | | A:\PC-ACCOU.NT 230,862 BYTES | | PCACT220.EXE 156,150 11/08/89 19:03:52 | | PCACT220.TXT 6,838 11/09/89 18:30:42 | | PCDOC220.EXE 67,874 11/08/89 19:09:22 | | | | A:\SHERLOCK 175,967 BYTES | | SHERLOCK.DOC 30,895 08/15/90 19:35:14 | | SHERLOCK.EXE 145,072 08/15/90 19:44:04 | |------------------------------------------------| | 9 Files 08-17-1990 18:46:00 | | | | | | | | | | | | | | | | Created by DISKLIST | -------------------------------------------------- This example is in the 5.25 inch normal format for that size diskette. DISKLIST can also print it in the 3.5 inch compressed format for the 3.5 inch diskettes, or in the 8.5 x 11 inch page format. There are 39 formats for you to chose from, all easily selectable from the DISKLIST control window. They contain from 1 to 6 columns of filenames. ASCII lines were selected for the frame of the above illustration so that it would print properly on all printers. If your printer -1- can print the IBM graphics characters (lines, boxes, etc.) then you can select IBM (unbroken) lines for your list and the frame will be smooth single or double lines. Such an example is given on the last page of this manual. Or you can select a format without any lines. Many of the formats do not have any border lines to save space so that you can print on stick on labels. They are identified with Label, Lab, or Page in the Format Size. Labels also leave off the 'Created by DISKLIST'. Printer control codes can in inserted in the program. The length of the label in lines can be set. In the label mode, DISKLIST will space to the next label. Each format has its own set of laser commands. All setup parameters are saved when you exit DISKLIST. FAST START To run DISKLIST, just enter DISKLIST at the DOS prompt. Read the Shareware screen carefully, then press RETURN. The control window and Help window are displayed. Read the Help window for instructions on how to navigate the DISKLIST control window. Press any key to close the Help window, it's available anytime by pressing H. If you are using a monochrome monitor, press M to toggle on an arrow to indicate the selected parameter. Setup the parameters as you want them, then press P to print a list. When registered (i.e. when you pay the author for DISKLIST), the program will skip the Shareware screen and the help window and be immediately ready for business. After you have used DISKLIST, enter the F command to print the registration form, fill it out and send it with $25 to the program author. Thanks. When DISKLIST starts, it is ready to print the directory on the drive it used last. This is easily changed from the DISKLIST control window in the program by selecting the first parameter and pressing the right or left arrow keys. You can also select the source directory drive from the DOS command by entering the drive letter (colon not necessary but accepted). For example, if you were going to print the directory of drive A: and the last drive DISKLIST used was B:, then the command would be: DISKLIST a -2- OPERATION When DISKLIST starts, it reads several data files. These files must be in the same directory as DISKLIST.EXE. If your operating system is DOS 3.3 or above, you can run DISKLIST from any directory and it will find its data files. For older versions of DOS, make the directory DISKLIST.EXE is in the default before running it. To run DISKLIST, just enter DISKLIST at the DOS prompt. After the Shareware screen, the DISKLIST control window will appear. Parameters D I S K L I S T Commands =================================================================== 1 - Disk Drive A: H or F1 - HELP A - Space Yes 2 - Filespec *.* P - Print List Z - ZIP No 3 - Sort Files by Name L - Line Feed E - Eject Page 4 - Sort Direction Ascending T - LPT1: 5 - Output Device NonLaser Printer S - Save Title on Disk Drive 6 - Format 5 Normal R - Read Title from Disk Drive 7 - Border Line Type ASCII |---| F - Print Registration Form 8 - Lines Per List 30 C - Configuration 9 - Title for List F10 or ESC - Quit DISKLIST The List Title is Displayed Here Illustration of the Control Window Press Function Key 1 or H to display the help window. It explains how to navigate the control window. The words Parameters and Commands on the control window only appear when the HELP window is active. Select a parameter by entering the sequence number of the parameter, or move the highlight with the up and down arrow keys. Change the parameter by scrolling through the allowable values with the left and right arrow keys or the space bar. If you are using a monochrome monitor, press M to toggle on an arrow to indicate the selected parameter. Be sure to select the proper printer (Laser or Nonlaser) with parameter 5, Output Device. A common problem is to have the wrong control codes sent to the printer because the wrong printer was selected. When parameters 2, 8 or 9 are selected, a window will open up for text entry. Press ESC to delete the previous entry, or edit it with the standard editing functions. Insert also works. When the entry is complete, press the up or down arrow key or RETURN. The input window will disappear. If you entered a title, it will -3- be displayed at the bottom of the control window. If you completed the entry with a RETURN, the highlight will stay on the parameter. Use the left or right arrow key to reopen the window. To execute a command, press the command letter when no other window is open. PARAMETERS and COMMANDS DISKLIST lets you configure your directory lists to your requirements. The configuration is saved when you exit DISKLIST and will be automatically read the next time DISKLIST is run. The parameters permit you to: Select any disk drive - floppy, hard, or ram disk. Provide a file selection specification, Filespec. Sort files by name, date, extension, size, or no sort. Sort direction - ascending, descending. Select an Output Device from these: Laser Printer, NonLaser Printer, Your Computer Screen, an Avery Laser Label, a Disk Sleeve on a LJ III, or Write to a Disk File. Select a form and print size - 39 formats available Select a border line type - None, ASCII dashes, IBM single or double lines. Change the number of lines to be printed on the list. Enter a title for the list. Read the list of commands from the Control Window figure. Most are self explanatory. The others are discussed below. DISKLIST supports two printer types. One is nonlaser (mechanical) printers and the other is laser printers. The difference has to do with which set of control codes DISKLIST sends to the printer. The control codes for mechanical printers are saved with the general setup parameters in the file DISKLIST.PRM and the laser printer commands are saved in DISKLIST.LSR. These will each be discussed separately. As you move through the Format selections with the right and left arrows, the Lines Per List data will change to reflect the value for that size parameter. When the Lines Per List parameter is selected, a window pops up for entry of the new value. The original value that came with DISKLIST is in parens for your reference. -4- When DISKLIST prints a list that is physically longer than the diskette, either 5.25 or 3.5 inches, it will put marks on the border indicating where to fold the paper to neatly match the disk size. In the ASCII border line type there is a - instead of the |. In the IBM border line type the horizontal tick mark is part of the vertical line and is harder to notice, but it is there. The line this prints on is determined by the value for Lines Per List. If you know that your list of files is short, set the Lines per List to a lower value with parameter 8 in the control. That will print a shorter frame. This is necessary when you are printing on a sleeve (with a Laser Jet III) and using a format that prints a border. The border line type selection does not apply when the 8.5 X 11 Page, any label format, or the Display on the File is selected. There are no borders on the 8.5 x 11 Page, Label or File outputs. When a format for one of these is selected, Border Line Type displays 'Not with above Fmt'. Actually the word 'above' is an upward pointing arrow on the screen. All of the borders are available on the output to the Screen. None of the compressed or multiple column modes are available when the output is directed to the Screen or File. For the nonlaser printer, when a mode that uses compressed print is selected, DISKLIST combines the codes for compressed on and 8 lines per inch (in that order) and prints a line with those codes. This will cause the printer to advance one line. Likewise, on completion of the list printing, another line with the codes for compressed off and 6 lines per inch will be printed. These two blank lines are included in the number of lines per list for the nonlaser printer. So, you can put any codes in these parameters. There is no limit to the number of codes you may use. When a non compressed format is selected, no codes are sent to the printer. For a laser printer, the laser commands are always sent. There is a set of laser commands for each format. The printer mode with the 8.5 x 11 Page format and the File mode are ideal for producing a list of all files on a hard drive and saving the list in a loose-leaf notebook. -5- The C command pops up the following Configuration menu. CONFIGURATION ═════════════════════════════════ 1 - NonLaser Printer Codes F5 2 - Laser Commands F6 3 - Form/Printer Sizes F7 4 - Date Format MM/DD/YY 5 - Download a Font F3 6 - Print Total Space at TOP Yes 7 - Print Date-Time at TOP No 8 - Print Date-Time at BOTTOM Yes 9 - Lines to skip at label gap 0 A - Line under Title & Label No B - A Blank Line at the Top No C - Print File Names Yes Select [Quit]? You may go directly to the window for selecting the Nonlaser Printer Control Codes (F5), the Laser Commands (F6), the Format editor (F7), or to download a font (F3) by pressing the associated function keys here or from the control window. To select another data format, press 4 until the date format you want to use is displayed. The date formats are: MM/DD/YY DD/MM/YY YY/MM/DD MM-DD-YY DD-MM-YY YY-MM-DD MM.DD.YY DD.MM.YY YY.MM.DD Toggle items 6 through 8 and A through C, Yes and No, by pressing the selection number. These give you more control over the look of your list and the space available for file names. When the date and time are printed at the top of the list, the number of files are not printed. The configuration setup is saved when you exit DISKLIST. Item 9, Lines to skip at label gap, will cause a nonlaser printer to skip lines between labels when printing a list that is longer than one label. This is intended to be used when printing on gummed mailing labels that will be stuck to a disk. Set Lines Per List, item 8 on the control window, to the number of lines from the beginning of one label to the beginning of the next label. Then enter the number of lines to be left blank. If Lines Per List = 10 and Lines to skip at label gap = 3, then DISKLIST will print 7 lines then skip 3, then repeat. DISKLIST will save the title for a disk in a file on that disk with the S command and retrieve it with the R command. DISKLIST also prints the disk volume name at the top of the list. -6- The E command (Eject Page) sends a form feed to the printer. The L command (Line Feed) sends a carriage return to the printer. CTRL R or CTRL E sends the laser printer Reset command, ESC E, to the printer to eject a page (it is not listed on the control window). When these commands are sent, DISKLIST acknowledges by beeping. If the beep is annoying, press CTRL B to turn the beep off. Another CTRL B will turn the beep on. Before DISKLIST prints the name of a subdirectory, it prints a blank line. The blank line can be avoided by toggling the status of Space to No by pressing the letter A. See the upper right corner of the control window. Notice the Z - ZIP in the upper right corner of the control window. It signifies the status of DISKLIST reading the file directory in ZIP, ARC, PAK, ZOO, and LZH files. These file names are displayed in lower case letters to signify that they are from an archive. These file names are not sorted. Pressing Z toggles the status of this function between Yes and No. LIST FORMATS DISKLIST provides a large selection of list layouts. Some contain all the file information, name, size, date, and time. Others contain only the name, or the name and date, or the name and size. You may have from one to six columns of file names on a list. Remember, Label formats do not print any border lines and they skip to the beginning of the next label based on the value in Lines Per List. They also do not print Created by DISKLIST. The following table lists all of the Formats and indicates which use the compressed mode. Avery stands for Avery Label. It is also a regular label format. Sized for Format Diskette Columns Info Printed Pitch Type 8.5 x 11 Page 8.5 x 11 1 Name Size Date Time Page 3.5 Compressed 3.5 1 Name Size Date Time Compressed List 3.5 Comp Label 3.5 1 Name Size Date Time Compressed Avery 3.5 2 & Size 3.5 2 Name Size Compressed List 3.5 2 & Size Lab 3.5 2 Name Size Compressed Avery 3.5 2 & Date 3.5 2 Name Date Compressed List 3.5 2 & Date Lab 3.5 2 Name Date Compressed Avery 5.25 Normal 5.25 1 Name Size Date Time List 5.25 Norm Label 5.25 1 Name Size Date Time Label 5.25 Compressed 5.25 2 Name Size Date Time Compressed List 5.25 Comp Label 5.25 2 Name Size Date Time Compressed Label 5.25 2 & Size 5.25 2 Name Size List 5.25 2 & Size Lab 5.25 2 Name Size Avery -7- Sized for Format Diskette Columns Info Printed Pitch Type 5.25 2 & Date 5.25 2 Name Date List 5.25 2 & Date Lab 5.25 2 Name Date Avery 5.25 3 & Size 5.25 3 Name Size Compressed List 5.25 3 & Size Lab 5.25 3 Name Size Compressed Avery 5.25 3 & Date 5.25 3 Name Date Compressed List 5.25 3 & Date Lab 5.25 3 Name Date Compressed Avery 5.25 4 & Size 5.25 4 Name Size Compressed List 5.25 4 & Size Lab 5.25 4 Name Size Compressed Label 5.25 4 & Date 5.25 4 Name Date Compressed List 5.25 4 & Date Lab 5.25 4 Name Date Compressed Label 3.5 3 Across 3.5 3 Name Compressed List 3.5 3 Across Lab 3.5 3 Name Compressed Avery 5.25 3 Across 5.25 3 Name List 5.25 3 Across Lab 5.25 3 Name Label 5.25 4 Across 5.25 4 Name Compressed List 5.25 4 Across Lab 5.25 4 Name Compressed Avery 5.25 5 Across 5.25 5 Name Compressed List 5.25 5 Across Lab 5.25 5 Name Compressed Label 5.25 6 Across 5.25 6 Name Compressed List 5.25 6 Across Lab 5.25 6 Name Compressed Label Page 2 with All 8.5 x 11 2 Name Size Date Time Compressed Page Page 3 & Date 8.5 x 11 3 Name Date Page Page 4 & Date 8.5 x 11 4 Name Date Compressed Page Page 4 Across 8.5 x 11 4 Name Page Page 5 Across 8.5 x 11 5 Name Compressed Page Page 6 Across 8.5 x 11 6 Name Compressed Page The format to use is selected with item 6, Format, on the control window. There are 39 selections. The display at the bottom of the control window screen displays information from the above table. It explains the selected format in more detail. Columns are the number of groups of data that are printed on a line and Info Printed is the data in each group. This display can be toggled on and off with CTRL L. The formats 5.25 2 & Date and 5.25 2 & Size print compressed when the Output Device is Avery-Laser so they fit on the Avery label. DISKLIST provides a way for you to quickly select a format. F7 displays the Configuration Format Menu. Move the cursor to the format you want and press F10. That will then be the format selected to use in the command window. You can also use the Configuration Format Menu to create a list of formats that you want available from the control window. If, for example, you only have a 3.5 inch diskette, then you do not want to scan through all the selections for 5.25 inch drives. A diamond indicates formats selected to be available as options -8- from parameter 6 - Format on the control window. Select or deselect the items you want with the space bar. Use the cursor keys to move around the list. Press F10 when done. This configuration will be saved when you exit DISKLIST. Use the 8.5 x 11 format to list the files on your hard drive and put the pages in a notebook for reference. NONLASER PRINTER CONTROL CODES (Laser printers users skip 2 pages to LASER COMMANDS) DISKLIST has a generic set of nonlaser (dot matrix) printer control codes. It only uses the codes to switch to and from compressed (17 characters per inch) and regular (10 characters per inch), and between 6 and 8 lines per inch for the compressed printer modes. The default generic printer control codes work on many printers and have been tested on the Epson FX-86e and IBM Proprinter II. DISKLIST provides a nonlaser printer code editor. It is activated with the C command or directly with F5. Use it to install your printer control codes for these functions if the default codes do not work with your printer. It is easy to do this with information supplied in your printer manual. These printer control codes will be saved in the same file with the other DISKLIST parameters when you exit DISKLIST. When you enter the editor to change the printer codes, this window will pop up. The figure illustrates an example when key 1 was pressed to change the codes for compressed on. NONLASER PRINTER CODES ====================================== 1 - Compressed ON 15 2 - 8 Lines per Inch 27, 48 3 - Compressed OFF 18 4 - 6 Lines per Inch 27, 50 ====================================== 1 to 4 - Enter the Decimal Codes D - Restore the Default Codes R - Restore Before Entry Codes C - Clear All Codes F10 - Quit and Use these Codes ====================================== Enter the codes for Compressed ON ? 15,7,65 -9- Printer manuals contain a section or appendix on printer commands, software commands, or control codes. These codes are sent from the computer to the printer by DISKLIST to change the character size and line spacing. If DISKLIST doesn't print the directory list in a conventional format, use the nonlaser printer code editor to tell DISKLIST what codes to send to your printer to make it print correctly. Your printer manual may have the codes in three different formats, ASCII, decimal, and hexadecimal. Only enter decimal codes into DISKLIST. These are all numbers between the values of 0 to 127. There are usually 1 to 3 numbers for each function being changed. Enter all of the numbers for one function on one line and separate the numbers with a space or comma. There is no program limit to the number of control codes you may enter. The above figure of the codes window illustrates how a new code is being entered for the function Compressed On. To delete the line of codes on the prompt line, press the ESC key. DISKLIST will only accept numbers from 0 to 255. It will ignore all other numbers and beep as it does. It will accept any quantity of numbers for each function but will only display those that fit in the window. DISKLIST only transmits these codes to the printer when a compressed mode is selected. See the table that defines the print formats on or near page 7. When data on the prompt line exceeds the width of the window, then the prompt line scrolls horizontally. You can then scroll the data horizontally with the cursor keys; the display window shows only the numbers that fit in the window. The D command on the Printer Codes window will restore the built in codes that came with DISKLIST. If you want to print the IBM graphic lines on a DISKLIST listing, then you must select the IBM mode on your printer. Try printing a directory list with the IBM lines selected in DISKLIST with the Border Line Type parameter. If it does not print the IBM lines, read your printer manual to locate the switch to flip to activate this mode on your printer. This applies to dot matrix printers only. You can now print the title and disk volume name in double strike on dot matrix printers. Create a file named DISKLIST.C1. Put in the decimal values of the codes to select double strike, separated by a coma, and followed by a negative value that indicates the quantity of values you entered after the ESC. Do -10- the same on the next line to cancel double strike. Try the enclosed file, DISKLIST.C. Rename DISKLIST.C to DISKLIST.C1. It works on most dot matrix printers. The contents of DISKLIST.C1 are: 27,71,-1 27,72,-1 If you do not have a laser printer, you may delete the file DISKLIST.LSR so DISKLIST doesn't have to take the time to read it. LASER COMMANDS DISKLIST has a set of laser commands in the file DISKLIST.LSR for each format. It also has a laser command editor, accessed with F6, so you can easily change them. The laser commands are setup in the following categories: Symbol Spacing Pitch & Point Size Orientation Top Margin Lines per inch Left Margin, Row Reset You can put any commands on any line. These categories are for reference only. Just remember, when laser printer is selected, DISKLIST concatenates all of the commands in the first 7 categories and sends them to the printer. After the list is printed, DISKLIST sends the commands in the eighth category, Reset. You don't have to have any laser commands, and there is a key (F8) to delete all commands for a format. Or, you can delete the file DISKLIST.LSR and that will clear out all of the commands and DISKLIST will still run. For Output Device selections Avery-Laser and Sleeve on LJ 3, the laser commands are in the program and cannot be changed. Laser commands are all printable ASCII characters except ESC. The IBM character set displays ESC as a left pointing arrow. So does DISKLIST. To enter ESC on the command line, just press the ESC key. Now, since the ESC key is used for input, how do you get out of the editor? Press Function Key 10. To be consistent, DISKLIST will quit all functions when F10 is pressed. There is a space after ESC in this documentation for clarity. In the actual HP laser command there is no space. In the laser command editor the ESC is displayed as a left arrow with no -11- space. The laser editor has the following functions: F1 - Help F2 - Copy to Pass Buffer F3 - Insert from Pass Buffer F6 - Insert Default Commands F7 - Clear Active Command Line F8 - Clear All Commands for this size F9 - Save All Commands for all sizes F10 - EXIT When in the laser editor, you may select another format with F11 & F12, or ALT or Control with the left and right arrows. The file DISKLIST.LSR is an ASCII file. It can also be edited with a text word processor like EDIT in DOS 5.0 or PC-WRITE. Each format has an ID number. These numbers and the format name are written to the file so you can locate the commands. When DISKLIST reads this file, it uses the ID number to identify the format, but it ignores the name. It only needs the commands for the formats that you want to use, and the formats do not have to be in sequence in this file. The default laser commands include a reset command ESC E with the symbol command ESC (10U. The HP reset command is ESC E. If you want to print more than one list on a page, then remove both of the reset commands (ESC E) because it forces a form feed. You may then force a form feed with E for Eject Page or CTRL R from the control window. CTRL R sends the laser command ESC E to the printer. So does CTRL E, ALT R, & ALT E. If your laser printer always ejects a blank page when using DISKLIST, then remove the first ESC E. Some users have reported that problem. The top margin command is ESC &l#E. That is a lowercase L before the # sign and not the number 1. Replace the # with the line number of the top line of the label. You may want to change the laser commands that adjust where the label is printed, i.e. the starting left margin and top row. The default commands for these are ESC &a0l1R. Again that is a lower case L after the &a0. These define the upper left corner of the list. Replace the zero with the number of the column to start the list (left margin) and the one with the line number (row). You may want to try replacing the one before the R with a zero to print closer to the top of the page. Some laser printers may cut off the top part of the first line if you print on row zero. You may want to print multiple labels on one sheet. First remove the ESC E commands. Press F6 to get into the Laser Command Setup -12- to remove the ESC E. After printing the first list, press F6 to get into the Laser Command Setup again. Move down to Left Margin, Row, and change the HP command of what line to start on. Change the decimal number before the R in the command string from 1 to 30. After printing the second list, press Ctrl E to eject the page. Try other numbers to gain experience positioning the list where you want it. You may print starting at row 30 first, then delete the 3 and print to row 0 next. Think of a laser printer as a screen where you can jump around the page and not as a dot matrix printer where you always have to print from top to bottom. 3½ inch formats can be printed side by side, as is done for Avery labels. F2 and F3 operate a pass buffer. They are used to copy the laser commands one format to another. F2 copies the laser commands from the displayed format to the pass buffer. Select another format, press F3 and the laser commands from the pass buffer are copied to this format. F9 saves all the laser commands to the file DISKLIST.LSR. DISKLIST will not automatically save the laser commands when it quits like it does the configuration - so use F9. F6 will replace all the laser commands for one format with the default laser commands that were originally in DISKLIST.LSR. DISKLIST prints the disk volume name and the title in bold italic. If the font does not have bold italic, the printer will print normal. The command that is sent for bold italic is ESC (s1s7B and to return to normal, ESC (s0s0B. These commands are coded into DISKLIST and can't be changed. If this causes problems with any printer, please let me know and I will fix the problem. If you are only going to use DISKLIST with a laser printer, I suggest that you remove all nonlaser printer codes. See the previous section on Nonlaser Printer Control Codes. Use the C command to clear all codes then exit. Select Laser Printer for item 5 on the Control Window. This will prevent the accidental sending of nonlaser codes to a laser printer. See the file DISKLASR.DOC for additional information on laser commands. DESKJET The Hewlett Packard DeskJet has commands similar to the HP LaserJet. Select Laser Printer for the Output Device in the control window. -13- For compressed print, the DeskJet, without a font cartridge, always prints 6 point characters. Compressed print on laser and dot matrix printers is 8.5 point. The effect of this is that the vertical lines did not connect to form a contiguous frame like it does in the normal 10 cpi mode. I was able to make the compressed lines print closer together by using the laser command editor (F6) to change the Lines per inch command from ESC &l8D to ESC &l12D. This changed the lines per inch from 8 to 12. The Output Device Avery-Laser doesn't work properly on a DeskJet because, unlike a laser printer where the paper doesn't move until a page is ejected, the DeskJet moves the paper when printing the first label, and can't backup to begin printing the second. You may still use the Avery-Laser feature by printing one column of labels only. AVERY LASER LABELS DISKLIST now prints on Avery labels #5196 and #5197. You may select exactly which label to print on, and how many copies to make. If you want to make more copies than will fit on a sheet, DISKLIST will eject a full sheet and continue on the next. You can also tell DISKLIST what label positions on the Avery sheet to not print on. Once DISKLIST prints on a label or you mark it to be skipped, DISKLIST remembers for that sheet. You can print the labels for 9 disks on the sheet for 3.5 inch disks and 12 on the sheet for 5.25 inch disks. Remember to press ALT E to eject a partial page. When you press P to print on a different output device, other than File or Screen, after you printed on the Avery-Laser output device, DISKLIST will automatically eject the sheet in the laser printer, provided you haven't switched the printer port (the LPT number - described below) also. All of the laser commands to locate and print on Avery labels are imbedded in the program. They are standard HP commands and should work on any laser printer that emulates the HP. Not all label formats will fit on these labels, so DISKLIST indicates the types that do as 'Label - AVERY' under Type at the bottom of the screen. Select 'Avery-Laser' for the Output Device (Parameter 5 in the Control Window). Select a Format that supports Avery labels. This information is displayed at the lower right corner of the screen under Type. If this information is not displayed, press control L. The type needed is Label - AVERY. When you press P to print the label, one of the following screens will appear depending on the disk label size: -14- AVERY Label Sheet # 5196 ┌─────────┬─────────┬─────────┐ │ │ │ │ │ │ │ │ │ 1 │ 2 │ 3 │ Select a Label Position to │ │ │ │ use (ESC to Exit) [1]? │ │ │ │ ├─────────┼─────────┼─────────┤ Enter a negative value to mark │ │ │ │ a position as used. │ │ │ │ │ 4 │ 5 │ 6 │ │ │ │ │ │ │ │ │ ├─────────┼─────────┼─────────┤ │ │ │ │ │ │ │ │ │ 7 │ 8 │ 9 │ │ │ │ │ │ │ │ │ └─────────┴─────────┴─────────┘ AVERY Label Sheet # 5197 ┌──────────────┬──────────────┐ │ 1 │ 2 │ │ │ │ ├──────────────┼──────────────┤ Select a Label Position to │ 3 │ 4 │ use (ESC to Exit) [1]? │ │ │ ├──────────────┼──────────────┤ Enter a negative value to mark │ 5 │ 6 │ a position as used. │ │ │ ├──────────────┼──────────────┤ │ 7 │ 8 │ │ │ │ ├──────────────┼──────────────┤ │ 9 │ 10 │ │ │ │ ├──────────────┼──────────────┤ │ 11 │ 12 │ │ │ │ └──────────────┴──────────────┘ If you want to prevent printing in a specific position on a sheet, enter the position number as a negative value. If you want to block out label 4, enter -4. DISKLIST fills used cells on the screen to indicate labels that are not available. After selecting a position to print, you will be asked how many copies. If you have already printed one label and it was cell 3, and you select to print the next label in cell 4, and then you -15- request 4 copies, DISKLIST will print the four copies in cells 4, 1, 2, 5. It did that because 1 and 2 were not used or blocked. PRINT ON DISK SLEEVES DISKLIST will print lists and label formats, both 3.5 and 5.25 sizes, on the sleeve of 5.25 inch diskettes. However, this works ONLY ON PRINTERS WITH PCL5 and ONLY ON PLAIN PAPER SLEEVES, NOT TYVEK. PCL5 is standard on HP Laser Jet III series and available on newer versions of some other brands. The reason it only works with PCL5 is because DISKLIST uses a PCL5 command that causes the laser to print upside down. The reason for this will become evident in the next paragraph. Do not use Tyvek sleeves because they may melt in the printer. Because of the short length of the sleeve, you must use the following procedure to ensure that the sleeve will travel through the printer. Cut a piece of 8.5 x 11 inch paper in half (two 8.5 x 5.5 pieces). Insert one piece into a plain paper diskette sleeve. Push it all the way to the bottom of the sleeve. Using the single sheet feeder, feed the sleeve and sheet into the laser printer, with the bottom of the sleeve going in first. The printer feeder mechanism will push the sleeve through the printer by pushing on the sheet of paper. Select 'Sleeve on LJ 3' for the Output Device (Parameter 5 in the Control Window). Select any format. If the format is too wide to fit on the sleeve, DISKLIST will tell you when you press P to print. All of the laser commands to print on the sleeve are embedded in the program. If there are more lines to print than will fit on a sleeve, the list will continue on the next page. You will have to adjust the Lines Per List, item 8 in the control window, to a lower value when you are printing a format with a border. This is to prevent the bottom of the border from being printed on the next page. SWITCH PRINTER PORT In the control window there is a command, T - LPT1:, to switch printer ports from LPT1: to LPT2: to LPT3:. Just press T. Try printing a DISKLIST if you have more than one printer. Remember to change the Output Device if one printer is a laser and the other is not. If it works, skip the rest of this section. Switching printer ports may not work if you are using a print spooler. It does work with the spooler I use, DMP. If you have a serial printer, you must have set it up with the DOS MODE command before starting DISKLIST. -16- PAGE TAB VALUE The Page format has built in tabs for the first column of each format. You may want to change them. Create a text file called DISKLIST.TAB. Enter the tabs you want for each of the seven page formats separated by commas. The default tabs starting with format 8.5 x 11 Page and ending with Page 6 Across are: 19, 22, 8, 23, 10, 30, 22. If the file DISKLIST.TAB is in the same directory as DISKLIST.EXE then DISKLIST will read it and use these values. Otherwise it skips it and uses the above default values. LASER DOWNLOAD DISKLIST will download your soft fonts for you. Here's how. Create an ASCII file with a text editor or word processor. Name this file DISKLIST.FNT. Insert the DOS file name and a description of the font. Place a comma after the DOS file name. You may enter up to 10 names, each must be on a different line. Example: CO085R16.USP, Courier 8.5 Point 16.6 Pitch RO100R12.UPS, Times Roman 10 Point 12 Pitch Copy your font files and DISKLIST.FNT to the directory with DISKLIST.EXE. Fonts do not come with DISKLIST. The download section is accessed by pressing F3 from the Control window, or selection 5 from the configuration window. DISKLIST will display the file names and fonts and you select the one to download. DISKLIST will download the font and select it. The HP command codes that DISKLIST uses are given in the file DISKLIST.LZR. You may have to change the laser commands, particularly the Lines per inch, to properly utilize this font, or delete them all with F8. You may also want to change the Lines per List, parameter 8 in the Command window. Also remove the two reset commands, ESC E, since either may delete the downloaded font. TEXT INPUT There are several prompts where DISKLIST asks for text input. All follow these rules. DISKLIST always presents the previous data in that field for you to edit if you wish. ESC will erase the entire line. All standard editing features of the computer are available: insert, delete, home, end, left and right arrows. -17- DISKLIST has a novel feature. If you want to enter more characters than will fit into the input window, then DISKLIST scrolls the text sideways. All data will not be displayed in the text window, but it will be used. One exception is the filespec input. It will truncate any input to eight characters before the period and three after the period to comply with DOS standards. When a title for a disk is entered, it will be displayed at the bottom of the control window as illustrated by the text in the control window display above, "The List Title is Displayed Here". To reuse the title, save it with the S command. DISKLIST will save it on the disk drive selected by parameter 1 on the control window. Retrieve it the next time with the R command. Press RETURN or the up or down arrow when you are finished with a text input. STATUS MESSAGES Status messages are displayed in a pop up window. In some cases, such as error messages, you are prompted to press any key to continue. In other cases, such as completion messages, they are displayed for a few seconds then go away. You do not have to wait for these latter messages to go away before entering a command. When you are producing a list, DISKLIST will display the path and file names as it prints them in a status window. Sometimes this goes too fast to read, but the purpose is to let you know that something is happening. DISKLIST will STOP PROCESSING a list IF ANY KEY IS PRESSED and beeps to alert you that it stopped prematurely. When you accidentally start to print the directory of your hard drive, press any key to stop. DISKLIST requires 256 K of free memory and DOS 2.1 or later. MONOCHROME MONITOR The highlight of the selected parameter in the Control Window and the Format Selection Window may not be visible on monochrome monitors. To make it possible for such users to know which parameter is selected, press M to toggle the display of arrows before the item on and off. -18- SUMMARY OF NON-DISPLAYED COMMANDS. M Toggles display arrows for monochrome monitors. ^B Toggles the blind command action beeper on/off. ^L Toggles display of Format data at bottom of screen. ^E Sends the laser printer reset command ESC E. ^R Sends the laser printer reset command ESC E. ^ means hold the Control Key down, then press the letter. You may use the ALT key instead of the Control Key for these four keys. FILENAMES The names and purpose of all DISKLIST system files are listed below. There are no hidden files. Only the first five files are distributed with DISKLIST. The next three are created by DISKLIST, and the last two are created by you. DISKLIST.EXE Program DISKLIST.DOC Documentation DISKLIST.LSR HP LaserJet Commands for each format DISKLASR.DOC Additional documentation on LaserJet Commands DISKLIST.C Data file for double strike printer codes Change name to DISKLIST.C1 to use DISKLIST.PRM Saved program configuration & nonlaser printer control codes DISKLIST.TTL Disk title DISKLIST.TXT Default file name or a list output to a disk DISKLIST.FNT File containing names of your softfonts DISKLIST.TAB Optional tab values for page formats -19- DISKFLAP Lists for 5.25 inch disks can be kept in the disk sleeve. Some 3.5 inch disks have plastic sleeves, but few people use them. DISKLIST lists can be attached to a 3.5 inch disk in a way that allows them to remain attached when inserted in most floppy drives. The list can even be read when it is in horizontal drives. This is accomplished by tapping the list to the back of the diskette with one small piece of tape placed along the edge of the diskette that doesn't go into the drive. You then have a list that stays attached to the diskette even when it is inserted in the drive. Edge of disk that does not go into drive _______=====________ _ <-----Masking Tape Hinge | | | |\ | [] | | | \ | | | | \ | | | | \<------ List printed | 0 | | | \ by DISKLIST | | | | \ Printed side | Front of | | | \ out | 3.5 " disk | | | \ | | | | \ \___________________| |_| Front View Side View The tape only has to be 3/4 to 1 inch by 1/2 inch. When you cut the list out, leave about 1/4 inch of paper above the printed frame of the list. Place the list on the back of the disk with the top edge of the list along the back edge of the disk, printed side out. Tape the list to the disk. The tape acts as a hinge so the list can fold against the disk for storage, or fold straight out away from the disk when the disk is inserted into the drive. Masking tape works best and the list can be pulled from the tape to be replaced. Scotch tape also works. SHAREWARE DISKLIST is NOT a public domain program. It is copyrighted and distributed as Shareware. DISKLIST may be distributed on bulletin boards, by computer user groups and by disk vendors. -20- DISKLIST.EXE, DISKLIST.DOC, DISKLASR.DOC, DISKLIST.LSR, and DISKLIST.C must be distributed together and unaltered. If, after evaluating DISKLIST, you decide to use it or keep it for when you will need it, then you MUST submit the registration fee. The registration form must be printed from DISKLIST with the F command. When you register DISKLIST you will receive: Telephone and mail support. A copy of the latest version of DISKLIST Removal of the Registration Screen & reminders. Skip the Help screen at start of the program. Skip the Registration Form reminder at the end of the program. A loan amortization program with both the BASIC source code and the compiled program. No registration is required for the amortization program. A Copy of SHERLOCK for you to try before registering. You will also receive a free introductory membership certificate to CompuServe with a $15.00 credit towards online time. Your registered copy of DISKLIST will NOT display the initial Shareware title screen, the registration reminders, or the initial or laser command setup help screens. Because I will send you all of this software, please indicate on the registration form the size of the floppy disks that you can use. The registration fee is 25.00. Maryland residents add 5% state sales tax ($1.25). Orders outside of the United States add $3 for postage & handling. All checks and money orders must be in US funds and drawn on a US bank. Visa, MasterCard or American Express may be used. This price may change, but not in 1992. Most copies of software on bulletin boards and even in software vendor libraries are not the latest version. It takes a long time for these to get around, and most of the effort is placed on the widest distribution of the initial release. And with so much emphases being placed on 'safe software' these days, where is there a more reliable place to obtain your software than directly from an ASP author. Once in a while DISKLIST will act like it is registered for non registered users. It starts running without the shareware screen and displays a window with the message 'Will Run as if REGISTERED' just to show you how it will run when registered. -21- MULTICOPY FEES The following is the schedule of the multi-copy license fees. The fee includes one master diskette which you may then copy and use on the number of machines listed below: # Users Price ------- ------- 5 $ 100.00 ($20 per copy) 10 190.00 ($19 per copy) 25 425.00 ($17 per copy) 50 750.00 ($15 per copy) 100 1,200.00 ($12 per copy) Site 2,500.00 For corporate, educational institution, and network discounts, contact Gulf Sierra. FOREIGN REGISTRATIONS Registrations from outside of the United States may be made by sending a check or money order drawn on a US bank in US funds, a Postal Money Order in US Funds, VISA, MasterCard, or American Express. Or, you may arrange to send funds in your currency to a disk vendor in your country who agrees to forward the full registration fee in US funds and your name and address to Gulf Sierra. Gulf Sierra will then send the registration package directly to you. Contact a disk vendor for details and amount to send him. Vendors may apply a small handling fee. Some vendors who have agreed to do this and will send your name and registration fee to me by electronic mail are: BUDGETWARE, 9 Albermarle Street, Newtown NSW 2042, AUSTRALIA Phone 011-612-519-4233 DKR Software, P.O. Box 372, Brighton, South Australia 5046 Phone 08 3770049 COPYSOFT, Rue de Menuisier 109, 1200 Bruxelles, Belgium EPILOGUE Please report discrepancies (bugs) that you find in DISKLIST. Include sufficient information for me to replicate the incident. When I correct a bug, the person who reported it gets the first copy. Whenever you write, please include your home phone number. You can also send CompuServe mail to me. My CompuServe ID is -22- 73270,77. I usually answer questions by phone on the weekend or early in the evening Eastern time. If you do not like DISKLIST, please let me know that you tried it and, if you wish, why you will not use it again. Tell me what features would have made DISKLIST useful to you. Perhaps you had a problem because I didn't clearly convey how to use it. Many features in my software were suggested by people who did not register. And of course, many more were suggested by those who did. You may use the registration form to reply and cross out the word Registration. COMMERCIAL LABELS One company that produces stick on labels for both form fed printers and laser printers is Avery. These labels are available from many office supply stores and catalogs. The Avery disk labels are: Catalog Label Size Number For 3.5" disks and form fed printers 2.75 x 2.75 4241 For 5.25" disks and form fed printers 1.25 x 4.75 4240 For 3.5" disks and laser printers 2.75 x 2.75 5196 For 5.25" disks and laser printers 1.50 x 4.00 5197 OMBUDSMAN I am a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the Shareware principle works for you. If you are unable to resolve a Shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427 or send a CompuServe message via CompuServe mail to ASP Ombudsman 70007,3536. -23- IBM GRAPHICS EXAMPLE This is an example of another format for the DISKLIST output. It can be seen on the computer screen and printed on a printer setup for IBM graphics. If this figure is not framed in continuous lines, then your printer is not setup for IBM graphics. Read your printer manual to determine if it is possible to switch to that mode. Otherwise, you can still use DISKLIST with the ASCII character frame as illustrated on page 1. ┌────────────────────────────────────────────────┐ │ GREAT SHAREWARE │ │ Volume ID is DISKLIST │ │ 1,457,664 Total Space 893,440 Bytes Free │ ├────────────────────────────────────────────────┤ │ A:\ 153,664 BYTES │ │ DISKLIST.DOC 34,377 08/15/90 19:32:16 │ │ DISKLIST.EXE 119,144 08/14/90 22:02:18 │ │ DISKLIST.PRM 124 03/25/90 11:11:48 │ │ DISKLIST.TTL 19 03/25/90 11:05:06 │ │ │ │ A:\PC-ACCOU.NT 230,862 BYTES │ │ PCACT220.EXE 156,150 11/08/89 19:03:52 │ │ PCACT220.TXT 6,838 11/09/89 18:30:42 │ │ PCDOC220.EXE 67,874 11/08/89 19:09:22 │ │ │ │ A:\SHERLOCK 175,967 BYTES │ │ SHERLOCK.DOC 30,895 08/15/90 19:35:14 │ │ SHERLOCK.EXE 145,072 08/15/90 19:44:04 │ ├────────────────────────────────────────────────┤ │ 9 Files 08-17-1990 18:46:20 │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ Created by DISKLIST │ └────────────────────────────────────────────────┘ This is shown in the 5.25 inch normal format. DISKLIST can also print in 38 other formats. -24-